home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / xkb-data / README.Debian < prev   
Encoding:
Text File  |  2008-09-17  |  3.5 KB  |  102 lines
  1. Notes about the Debian xkb-data package
  2. =======================================
  3.  
  4. Support of Apple keyboards
  5. --------------------------
  6.  
  7. Apple keyboards have been mostly unusable with XKB for years,
  8. and many unofficial files spread around the Internet to fix
  9. this mess.  Fortunately this issue has been fixed now, thanks
  10. to testers on the debian-powerpc mailing list, and changes
  11. have been merged upstream.
  12.  
  13. The following models are available:
  14.  * macintosh_old
  15.    For old kernels with ADB keycodes
  16.  * ibook powerbook macbook78 macbook79
  17.    Laptop, 3rd and 4th levels are obtained by the small Enter key.
  18.  * macintosh
  19.    Default Macintosh
  20. These models look for symbols in /usr/share/X11/xkb/symbols/macintosh_vndr,
  21. which means that the following layouts can be selected:
  22.    ch de dk es fi fr gb is it latam nl no pt se us
  23.  
  24. PC models can be selected, to have access to more layouts.  Some options
  25. may then be added to have the same behavior as with Macintosh keyboards.
  26. Here is a (non exhaustive) list of relevant options:
  27.  * lv3:lwin_switch   Press left Apple-key to choose 3rd level.
  28.  * lv3:enter_switch  Press Enter key on keypad to choose 3rd level.
  29.  * numpad:mac        Numpad keys work as with Macintosh keyboards.
  30.  * apple:badmap      Swap keycodes of two keys when Mac keyboards are
  31.                      misdetected by kernel.
  32.  
  33. Variants have been added to PC layouts to emulate Macintosh layouts.
  34. For instance,
  35.  
  36.     Option     "XkbRules"    "xorg"
  37.     Option     "XkbModel"    "ibook"
  38.     Option     "XkbLayout"   "fr"
  39.  
  40. in /etc/X11/xorg.conf can be replaced by
  41.  
  42.     Option     "XkbRules"    "xorg"
  43.     Option     "XkbModel"    "pc105"
  44.     Option     "XkbLayout"   "fr"
  45.     Option     "XkbVariant"  "mac"
  46.     Option     "XkbOptions"  "lv3:enter_switch,apple:badmap,numpad:mac"
  47.  
  48. Denis Barbier <barbier@debian.org>  Thu,  5 Oct 2006 22:51:12 +0200
  49.  
  50. Cleaning /etc/X11/xkb
  51. ---------------------
  52.  
  53. Since 0.8-3, all the files in /etc/X11/xkb/ were moved to
  54. /usr/share/X11/xkb/symbols. If you want to clean /etc/X11/xkb/, you need
  55. to run dpkg -P xlibs.
  56.  
  57. Customised layouts
  58. ------------------
  59.  
  60. Since 0.8-1, layouts are read from /usr/share/X11/xkb/symbols and no
  61. more from /etc/X11/xkb/symbols. Thus, layouts are no more conffiles.
  62. The good way to have a custom layout is to create one's own layout that
  63. includes other layouts and customises some keys you want to modify.
  64.  
  65. Do not modify directly files /usr/share/X11/xkb/symbols.
  66.  
  67. For instance, to create a French layout altering the 'a' key, create a
  68. /usr/share/X11/xkb/symbols/my_fr file containing the following lines
  69. (without the pipes):
  70.  
  71.    |   partial alphanumeric_keys
  72.    |   xkb_symbols "my_fr" {
  73.    |       include "fr"
  74.    |       key <AD01> { [ a, A, oe, OE ] };
  75.    |   };
  76.  
  77. To have it appear in your desktop environment layout manager, add
  78. "my_fr" in /etc/X11/xkb/base.xml as a new layout. For
  79. example, insert the following lines (without the pipes):
  80.  
  81.     |    <layout>
  82.     |      <configItem>
  83.     |        <name>my_fr</name>
  84.     |        <shortDescription>MyFr</shortDescription>
  85.     |        <description>French (customized)</description>
  86.     |      </configItem>
  87.     |      <variantList/>
  88.     |    </layout>
  89.  
  90. /etc/X11/xkb/base.xml is a configuration file.
  91.  
  92. Mohammed Adn├¿ne Trojette <adn+deb@diwi.org>  Sun, 23 Sep 2007 00:05:50 +0200
  93.  
  94. Your 'Fn' key is not working
  95. ----------------------------
  96.  
  97. On some laptops (Gateway MX6453 for instance), when X starts with
  98. numlock on, the 'Fn' key is toggled the wrong way. Just turn numlock off
  99. to get the 'Fn' key work again.
  100.  
  101. Mohammed Adn├¿ne Trojette <adn+deb@diwi.org>  Thu, 01 May 2008 02:36:13 +0200
  102.